WWWStat4Mac is a simple application designed to process the log files from httpd4Mac. It will also process log files from any application that outputs log files in the 'common log format'. This includes some UNIX web servers. So if you have a UNIX web server you might be able to process the log files on your Mac :-)
WWWStat4Mac is Shareware ($10). If you continue to use it you should pay for it. Please read the document WWWStat4Mac Registration for more information on how to register WWWStat4Mac.
_____________________
System Requirements
WWWStat4Mac requires system 7.0 or later. It would also be an advantage to have Mac TCP v1.1.1 (or later ) and Internet Config v1.1 (or later) installed to take advantage of some features. So the ideal minimal system would be System 7.5.3, MacTCP 2.0.6 or Open Transport 1.1 and Internet Config 1.2 ( but this is only a recommendation not a requirement).
_____________________
What does it do and how does it do it?
It's operation is extremely simple. Just drag your log file onto WWWStat4Mac or double click WWWStat4Mac and choose your log file using the process log menu item in the File menu. The file will then be processed and you'll finally be asked to choose a name and location for the output file.
_____________________
How can I control the output from WWWStat4Mac.
The first time that you run WWWStat4Mac it creates a file called “WWWStat4Mac Prefs” in the preferences folder. This preference file contains full documentation about all of the output options. So if you need to change the options just open the prefs file with your favourite text editor as it is just a TEXT file. If you are more ambitious and want to customise the output even further then all of the output strings are stored inside WWWStat4Mac as STR# resources so you can change those if you are prepared to use ResEdit or a similar resource editor.
_____________________
What is the img folder for?
This folder contains the GIF images that WWWStat4Mac uses to create the nice bars and graphics in the table output. Each of the bars is a separate GIF file that you can edit and change if you wish. The only important thing to remember is that the img folder has to be in the same directory as the output file that you have created and that it must have the name 'img'. If you change the name of the folder (directory) then the WebServer will not be able to find the images. The reason for this is that the paths names specified by WWWStat4Mac for the images are relative to the output file and include the name of the directory. If you must change the name of the folder (directory) then you will have to edit the output file to correct the links. This will become a user definable option in a later version.
_____________________
What is Simple Internet Version Control (SIVC)?
The Simple Internet Version Control protocol (SIVC - pronounced "civic") is a simple TCP/IP-based system to allow developers to determine the number of people on the Internet using their products. Code is built into WWWStat4Mac that can automatically, and transparently to the user, check-in with a server at a predefined, regular interval. The server
keeps a running count of the contacts it has received in that interval (or some multiple of that interval if averaging is to be used). This provides the developer with a reasonably accurate estimate of the product's current user base. In return the same server returns the current version of WWWStat4Mac and any development versions to the user. The user is then given the option to download a more up to date version of the software. More information about SIVC can be found at the following URL:
http://www.ots.utexas.edu/sivc/spec.html.
This version of WWWStat4Mac will only notify you of the latest release versions and not of any development versions. If you wish to know about development versions please send me an email. (phardman@ssci.liv.ac.uk)
_____________________
Where to get more information and latest versions WWWStat4Mac.
You can find more information about WWWStat4Mac and the latest versions and at the following URL:
http://sodium.ch.man.ac.uk/pages/wwwstat4mac.html
You can see the kind of output that WWWStat4Mac produces by looking at my server statistics at
http://sodium.ch.man.ac.uk/statistics.html
WWWStat4Mac is distributed as a FAT-Binary which will run on either 68K or PPC Macs separate 68K and PPC versions are available on special request :-)
New versions are also distributed to the info-mac ftp sites. For example the UK mirror URL for version 1.0.3 is
I am now using a shareware registration service run by Kee Nethery <shareware@kagi.com>. The big advantage for you (and me) is that you can pay shareware fees with your credit card (VISA, MasterCard and American Express) via email. This also makes it easier for people in other countries, since the currency conversions are handled automatically.
If you are a shareware author interested in this system, email Kee.
Please read the document WWWStat4Mac Registration for more information on how to register WWWStat4Mac.
Version History Only for those with a technical interest or just plain nosey-parkers :-)
1.1
This version is now shareware ($10) due to the large amount of effort that has gone into enhancing this version.
New Features
• Added DNS Lookups for logs. So now if the DNR is off in the web server or, there were unresolved names due to a slow name server they will be sorted out by WWWStat4Mac. Of course if the names are not in the DNS then they won't be resolved.
• Rewritten the file IO to use a buffering system. So now the file is read into memory in chunks of 64K.
• Have reduced this memory requirement by over 900K! Any site names that are longer than 80 chars will be truncated and listed as unresolved.
• Increased the number of sites that can be tracked to 10000 and still managed to reduce the memory allocation!
• Added code to check the file for errors. Any errors that are found are written out to a log file. The log file is created with the same creator type that the user has chosen in the prefs file. We should now be able to gracefully process any file that has all of the data on one line.
• Have added many more options for sorting data. Can now sort by size, number of hits, number of bytes, date, and number of visits.
• New output mode. Tables, with graphics! ( This of course requires a browser capable of doing tables. Eg. Netscape.)
• Added traffic statistics, so now can view traffic by hour, day of week, month and week of year!
• Added an auto-processing option. So now a file can be processed every 12 hours or whenever.
• Added a new menu option that lets you to open an editor for the prefs from inside the program.
• Added some more information to the progress dialog. Now while the program is analysing the data,info about the number or lines per second etc and estimated time of completion are shown.
Bugs Fixed
• Fixed a small bug that could cause problems if the string HTTP/1.0" was missing! This is now checked for and worked around.
• Fixed a bit of a conceptual bug in the Apple Event processing. This mean't that if the user opened WWWStat4Mac by double clicking and then dropped a file onto the application it would quit after processing. It should only quit if the file was dropped onto the app and it was this that launched it.
• Increased the stacksize of the PowerMac version to allow for more global variables.
• Fixed some problems with the SIVC dialog that could send it into an infinite loop of DNR lookups!
• Fixed the bad HTML.
• Fixed a problem with the stats for the total amount of data transfered. If a site was excluded, but the file was not it was possible for the file total to be greater than the site total.
• Fixed a problem caused by server logs that have an error. The file size is reported as ' - '. The
spaces were causing the line to be reported as too long. This is now dealt with.
• Replaced the FAT CDEF with a normal one as the FAT one didn't work correctly on 68000 machines.
_____________________________________
1.0.3
Added a preference that allows the user to define the default file by using the option map_default_to_file /filename.html. This makes it possible for UNIX users to define the name that '/' gets mapped to. If an old version of the prefs file exists and it has the map_default_to_home on then this automatically calls map_default_to_file with the filename of /home.html .
1.0.2
Added capabilities for wildcards in filenames and site names. So now it will be possible to exclude all machines from a site just by typing *.ch.man.ac.uk. etc. And similarly all files starting or ending with something *.gif /wwwstat4mac* etc.
Fixed a bug that caused problems with domain stats if the site name listed in the log file didn't end in a full stop '.' Now we just remove a full stop if it exists and then compare the strings. Also have now made it possible to add new domains through the new_domain option in the settings file. A domain is the Domain Name followed by the partial string that needs matching for example new_domain Apple_Computer.apple.com.
1.0.1
As always, a version ending in 0 had bugs. But only a very minor one that made the number of sites 0 if you had sites access statistics turned off. Have also increased the number of sites tracked to 4000. Hopefully I'll get some time soon to make these limits user defineable. Fixed a bug in the QUIT apple event. Now the application should quit if it was launched by dragging a file in the finder. Have also improved the speed of file saving by using a buffering system.
1.0.0 First non-development release.
Have now made the application completely 'standalone'. So when you run it without dropping a file on it you have to choose one using the file menu. Added support for SIVC (Simple Internet version control). This make the application slightly larger but means I can keep track of who is using it and lets users know when updates are available. Have made the about dialog box 'active' so that clicking on parts of it open up URL's for WWWStat4mac and Redpoint software. This requires Internet Config version 1.1 or later but is really cool :-).
Found the bug that Thom Dunaway had discovered with his clocked PowerMac. It occured today on my PB. It was going into an infinite loop at the end of the prefs file! This is now fixed!
Have added an abort while processing . This lets us abort during processing and also during saving. The progress bar now appears in the reading lines, analysing data and saving file parts.
Moved all of the strings to STR# resources. This will allow localisation to other langagus and for even more customisation of the output by users.
1.0b4 (Limited release to those people who'd sent me emails...)
Added an option to autosave the output file. This means that the program doesn't have to put up the save file dialog. This will allow files to be saved automatically and will make it easier to implement regular automatic running of the application.
Added a menubar to the program and made it so that it will now run in the background.
Added routines to convert the names of files to lowercase. This means that Setup.html is the same as setup.html.
Added mapping of / to /home.html. This is because these files are essentially the same.
Added an option to exclude files accessed by excluded sites.
Any file that is excluded, either separately or because it was accessed from an excluded site, is not included in the grand total or in the number of accesses.
Fixed a bug in the code that missed the end dates because it didn't read the last line (thanks Frank)!
Added domain statistics. Looks for all known domains as currently documented on the WWW. See preferences file for details of the URL.
I have done some timings on the latest codes for 68K and PPC and discovered that the 68K code is not that much slower than the PPC code (only about 10%). In fact the 68K code is actually FASTER (+10%) if 'Speed Emulator'
(part of Speed Doubler from Connectix) is installed!!
1.0b3.
This version adds support for various output options. These are
controlled by the file WWWStat4Mac Prefs. This file should be placed inside the
preferences folder in your system folder. If you don't do this WWWStat4Mac
will create a file containing the default preferences. If you need to change
the preferences then just edit them with your favourite text editor.
